home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Amiga Games: Greatest Hits 1996
/
Amiga Games: Greatest Hits 1996.iso
/
archive
/
userbox
/
publicdomain
/
atb213.lha
/
atb213
/
atb.doc
< prev
next >
Wrap
Text File
|
1996-05-28
|
15KB
|
377 lines
ATB quick documentation (note in english)
-----------------------------------------
I was urged to release this version of ATB by many users.
This release of ATB is a dead-end version, it is in fact
software dust. please do not send ANY emails with questions
about ATB. It was too much work to translate my interim
man page into portable english, so this quick documentation
is written in german and an old one (many, many features
are not described)
At the end of this document I've pasted some parts of the
source that you should read to understand most of the features
that are new.
! if you're not familar with "german", use someone else to
! help you.
! tip: visit #amigager (german amiga users IRC channel) and
! ask someone for (translation-) help.
---------------------------------------------------------------------
Amiga ToolBar 2.0 Features und Neuigkeiten
------------------------------------------
1.) Einleitung
==============
Amiga ToolBar wurde programmiert um einen flexiblen und kleinen
"ToolManager" für meine persöhnlichen Bedürfnisse zu besitzen.
Es sollte konfigurierbare Knöpfe besitzen und ein paar wichtige
Statusinformationen anzeigen sowie eine kleine Kommandozeile
für direkte Shell Eingaben besitzen. Um Farbe und Form nach
belieben zu ändern wurde es mit MUI 3.x programmiert, was auch
einige andere Vorteile mit sich bringt.
2.) Fähigkeiten
===============
Buttons:
+ Konfigurierbare Buttons zum Starten von Programmen
+ Piktogramme können als Argumente via Drag'n'Drop übergeben werden
+ persöhnliche Help-Bubble für die einzelnen Buttons
+ Button Beschriftung ist ein MUI Text, d.h. inline Grafiken möglich
+ Buttons auch per Tastatur aktivierbar (Tab,Return)
+ Buttons können in mehrere Zeilen aufgeteilt werden
+ Jeder Button hat seine eigene Konfiguration
Goodies:
+ Speicheranzeige für Chip/Fast
+ Screentitle Anzeige für Leute die den Screentitle abgeschaltet haben
+ Direkt-Kommandozeile für schnelle Aktionen (z.B. mount RAD: usw.)
+ Drag'n'Drop in die Kommandozeile
+ Position der Anzeigen durch Drag'n'Drop austauschbar
+ Breite der einzelnen Anzeigenelemente 'ziehbar'
+ Einzeln aktivierbar/abschaltbar
Fenster:
+ Fensterposition beliebig wählbar (Linke obere Ecke)
+ Feste Breite kann erzwungen werden
+ Vertikale oder Horizontale Anordnung der Knöpfe
+ Iconify des Fensters per Menu,Hotkey oder "Commodities Exchange"
+ MUI Fenster; d.h. Farben usw. einstellbar mit dem MUI Prefs Editor
Sonstiges:
+ Konfigurationsdatei wird notifiziert; änderungen an der Datei werden sofort übernommen -> gut zum Testen!
+ Konfigurationsdatei ist mit jedem bel. Texteditor erstellbar
+ "Cyclechain" für alle Bedienelemente
3.) Installation
================
Das Paket besteht aus dem eigentlichem Programm "ATB" (AmigaToolBar)
und einer Konfigurationsdatei. ATB kann nur aus der Kommandozeile
heraus gestartet werden und kennt nur diese beiden Argumente:
CFG=CONFIG/K,Q=QUIET/S:
CONFIG ist der Name der Konfigurationsdatei, d.h. man kann einen beliebigen
Platz auf seiner Festplatte für diese Datei wählen.
Wird kein Dateiname angegeben, so wird S:AmiToolBar.prefs verwendet.
QUIET unterdrückt die initiale Copyright Meldung.
Das Programm ATB sollte man sich in seinen Suchpfad kopieren, z.B. nach C:.
Der beste Platz zum Starten von ATB ist in der S:User-StartUp Datei;
folgende Zeilen sind zu ergänzen:
;BEGIN Amiga ToolBar
run <>NIL: ATB CONFIG=ENV:AmigaToolBar.prefs QUIET
;END Amiga ToolBar
Nun muss noch eine Konfigurationsdatei erstellt werden.
4.) Konfigurationsdatei
=======================
Die Konfigdatei hat ein bestimmtes Format und kann mit jedem bel. Texteditor
erstellt werden. Sie wird ZEILENWEISE abgearbeitet und benutzt die Notation
für AmigaDOS Kommandoschablonen (siehe AmigaDOS Handbuch).
Die ERSTE Zeile in der Datei wird mit folgender Schablone dekodiert:
"T=TOP/N/K,L=LEFT/N/K,W=WIDTH/N/K,R=ROWS/N/K,MD=MEMORYDISPLAY/S,TD=TITLEDISPLAY/S,CP=COMMANDPANEL/S,MDW=MDWeight/N,TDW=TDWeight/N,CPW=CPWeight/N"
JEDE WEITERE Zeile beschreibt einen Kommandoknopf und benutzt diese Schablone:
"TITLE/A,COMMAND/A,PATH/A,STACK/N/A,PRI/N/A,QUIET/S,WBSTART/S,HELP"
Alle Zeichen nach einem Semikolon (;) werden bis zum Zeilenende ignoriert, sind
also ein Kommentar. Beispiel:
; Dies ist ein Kommentar
WICHTIG! Die erste Zeile der Datei enthält globale Optionen und darf daher kein
Kommentar sein (darf aber einen Kommentar enthalten).
Globale Optionen:
----------------
T=TOP/N/K: Position der Fensteroberkante. Standard ist die grösstmögliche untere
Position auf dem Bildschirm
L=LEFT/N/K: Wie TOP, nur für die Linke Kante des Fensters. Standard ist soweit
rechts wie möglich
W=WIDTH/N/K: Hiermit kann man eine bestimmte Breite für das Fenster beantragen.
Wenn der Fensterinhalt aber nicht in diese Breite hineinpasst,
so wird MUI das Fenster selbstständig vergrößern!
R=ROWS/N/K: Gibt an, in wieviele Zeilen die angegebenen Buttons aufgeteilt werden
sollen, z.B. ROWS=2 für eine zweispaltige Buttonleite
MD=MEMORYDISPLAY/S,
TD=TITLEDISPLAY/S,
CP=COMMANDPANEL/S: Standardmässig wird kein Goodie aktiviert, sie werden mit
diesen Schaltern aktiviert. "MD TD CP" aktiviert z.B. alle
Goodies.
MDW=MDWeight/N,
TDW=TDWeight/N,
CPW=CPWeight/N: Die drei Goodies teilen sich die untere Zeile; mit diesen
drei Gewichten wird der beanspruchte Platz verteilt.
Button Optionen:
---------------
TITLE/A: Beschriftung des Buttons. Dies ist ein MUI Text, daher kann man
hier alle Steuersequenzen benutzen, die im MUI Developer Paket
beschrieben sind, z.B. Fett, Kursiv oder Inline Grafiken.
Beispiel: "\33I[5:sys:images/amiga.br]\33bShell"
(\33 soll der ASCII Code für Escape sein, also dezimal 27. Dies
kann man bei manchen Editoren direkt eingeben). Es wird geraten,
sich das MUI3xDEV.lha aus dem Aminet zu besorgen.
COMMAND/A: Das Kommando, das gestartet werden soll. Wichtig: am Ende der
Kommandozeile werden etwaige Argumente angehangen (z.B. durch
Drag'n'Drop). Werden zusätzlich Argumente verwendet, so sollte
man das Kommando und die Argumente in Anführungszeichen setzen,
Beispiel: "NewShell CON:///"
PATH/A: Das Verzeichnis aus dem heraus das Kommando gestartet wird. Viele
Programme verlangen aus ihrem Stammverzeichnis heraus gestartet
zu werden.
STACK/N/A: Die Stackgröße für das Programm
PRI/N/A: Die Prozeßpriorität für den zu erzeugenen Prozeß
QUIET/S: Stellt als Eingabe und Ausgabe NIL: ein. Dies ist wichtig,
da einige Programme wie z.B. Multiview sonst nervige
Ausgaben in die Bootshell machen
WBSTART/S: use wbstart.library to simulate WBSTART's
HELP: die Rest der Zeile kann für einen kleinen Hilfetext verwendet werden,
der in einer MUI Helpbubble erscheint, wenn man mit der Maus auf diesen
Knopf zeigt.
Hier ist ein Beispiel einer Konfigurationsdatei:
-----------------------------------------------
ROWS=2 MEMORYDISPLAY TITLEDISPLAY COMMANDPANEL
; the first line contains the global options
; here are the button descriptions, 2x3 buttons (ROWS=2!!)
"I[5:sys:images/amiga.br] Shell" "newshell CON:50/449/700/98" RAM: 4096 0 QUIET "Open a new bShelln window"
"I[5:sys:images/amiga.br] Delitracker" "DeliTracker2" AUDIO: 4096 0 QUIET "bDelitrackern 2.21 - Module Player"
"I[5:sys:images/amiga.br] Textview" "SYS:Utilities/TextView" RAM: 4096 0 QUIET "bMostn 1.57 - Text Viewer"
"I[5:sys:images/amiga.br] Multiview" "SYS:Utilities/Multiview" RAM: 4096 0 QUIET "bMultiviewn from Commodore"
"I[5:sys:images/amiga.br] View" "Work:Viewers/CyberView" RAM: 4096 0 QUIET "bCyberViewn - Picture Viewer"
"I[5:sys:images/amiga.br] Scout" "Work:Infotools/Scout" RAM: 8192 0 QUIET "bScoutn - System Monitor"
-----------------------------------------------
5.) Fragen und Antworten
========================
? ist eine Frage,
! ist die entsprechende Antwort
--
?: Wie bekomme ich eine Vertikale Leiste ?
!: Den ROWS= Parameter auf die Anzahl der Knöpfe setzen die man hat
und mit dem WIDTH= Parameter die Breite der Leiste einstellen.
Stellt man WIDTH=1 ein, so wird MUI die Optimale Breite finden.
Man sollte zusätzlich noch keines der Goodies anschalten, da diese
doch recht stören (zumindest alle 3 passen meistens nicht).
Will man mehr Spalten haben, z.B. zwei 10er Spalten, so definiert
man sich 20 Buttons und setzt ROWS=10.
?: Wie starte ich AREXX Skripte mit ATB ?
!: Eine Möglichkeit ist diese mit RX zu starten
?: Und wie starte ich Workbench Programme mit TOOLTYPES ?
!: Im Aminet sollte es Programme geben, die einen Workbench-
Start vom CLI aus simulieren. Damit sollte es vorrübergehend
klappen, ich habe es aber noch nicht getestet. In einer
nächsten Version wird es auch einen Workbench Start geben.
?: Wenn ich die Anzeigen in der unteren Zeile neu anordne, so wird
dies nicht gespeichert.
!: Leider müssen diese Werte zur Zeit von Hand in das Konfigurations-
file eingetragen werden
?: konfigurieren von Hand ist mühsam; gibt es denn keinen Prefseditor ?
!: Doch, aber der ist nicht von mir. Die Veröffentlichung liegt beim
anderem Autor, vielleicht wird der Editor im nächsten Paket enthalten
sein.
?: Wie bekomme ich den Text zentriert und wie bekomme ich diese kleinen
Bildchen in den Buttontext ?
!: Indem du dir die MUI Developer Dateien besorgst und in der Sektion
TEXT und IMAGES in den mitgelieferten Autodocs nachliest, wie das
geht.
?: Ich habe die erste ATB Version schon benutzt, und jetzt sind die
Texte in den Buttons nicht mehr zentriert. Wieso ?
!: Weil ich die voreingestellte Zentrierung ausgeschaltet habe. Man
muss nur ein <ESCAPE>c voransetzen um sie wieder zu aktivieren
?: Ich will ein 16x16 Bild benutzen mit einem 13 Punkte hohem Font...
!: ..aber vom Bild werden nur 13 Punkte höhe angezeigt ? Die Bilder
dürfen nur so hoch sein wie der Punkt. Es gibt eine unelegante
Lösung für das Problem: man erstellt einen 16 Punkte hohen Font,
der z.B. nur 10 Punkte hoch ist und oben und unten 3 Pixel frei
läßt - zugegeben, ziemlich miese Methode.
?: Mein Inline Image ist nach rechts hin immer kaputt.. ?
!: Dann hast du das Bild nicht korrekt abgespeichert/erstellt. Manche
Programme sichern Brushes falsch. Diese Frage sollte aber eher an
die MUI Autoren geschickt werden.
?: Wenn ich manchmal auf einen Button klicke, so passiert nichts ausser
das die Kommandozeile aktiviert wurde...?
!: Evt. ein MUI Bug: du hattest zuletzt das Stringgadget aktiviert und
dann ein anderes Fenster aktiviert. Klickst du nun in ATB, so wird
das Stringgadget wieder aktiviert, dein Klick aber "verschluckt".
Ich habe noch keine Lösung für dieses Problem...
?: Manchmal kann ich keine Piktogramme mehr auf ATB werfen, es erscheint
dann eine Fehlermeldung..?
!: Ups! Das sollte nicht mehr passieren. Einfach im Menu "MUI Settings"
aufrufen und die Einstellungen "Sichern". Ich habe dieses Phänomen
auch schon ab und zu gehabt und weiss wirklich nicht wieso.
6.) Tips zur Einstellung
========================
Diese Sektion beschreibt Einstellungen mit dem MUI Prefs Editor,
die ich für besonders sinnvoll halte im Zusammenhang mit ATB:
Dies soll nur als Anregung gedacht sein, jeder sollte mit MUI
seine Oberflächen nach seinem Geschmack einstellen.
Ich beziehe mich hier auf MUI 3.3 Prefs
"System"
Iconify:
- Hotkey: frei nach wahl, RechteAmiga-i im Programm eingebaut
- Zeige: Icon
Arexx: aus
"Fenster"
Kontrolle:
- Positionen: am Ende merken
- Refresh: smart
- Neuzeichnen:mit Löschen
- Knöpfe: keine
Abstand: 1-1-1-1
"Gruppen"
Rahmen:
- Normal: keiner, Links=Rechts=4, Oben=Unten=1
Abstand: 1-1
"Strings"
String Farbe (inaktiv):
- Hintergrund/Text: schwacher Kontrast (hellgrau/dunkelgrau)
String Farbe (aktiv):
- Hintergrund/Text: starker Kontrast (weiss/schwarz)
Weiterhin sollte darauf geachtet werden, daß das Stringgadget, die
Fortschrittsanzeige und die Textfelder annähernd die gleiche Höhe
haben, da es sonst zu unschönen Treppen kommen kann.
7.) Distribution, Dankeschön und Autor
ATB ist Freeware, es darf kein Profit einzig und allein mit dieser
Software gemacht werden. Das Copyright bleibt bei den Autoren.
Jede kommerzielle Distribution ist grundsätzlich erlaubt, wenn die
Autoren ein Exemplar des zu Distributierenden Objektes kostenlos erhalten.
"Dankeschön" an alle die mir fleissig EMail geschickt haben mit vielen
Verbesserungsvorschlägen und Fehlerberichten. Ich hoffe ich kann alle
mit dieser Version fürs erste eine Zeit lang bei Laune halten :-)
Besonderen Dank an "Phanlord" alias Aris Basic, der mir einen voll funktions-
fähigen Preferences Editor geschrieben hat! Leider mußte ich das Preferences
Format geringfügig ändern, so daß man den tollen Editor jetzt nicht mehr
benutzen kann. ;-( Aber wer weiss..
Autor:
Daniel Balster, student of computer science and math @uni-paderborn.de
----------------------------------------------------------------------
some stuff for you to discover:
-- all used templates for commando line parsing:, some are useless actually
from classes/ButtonPanel.c
options of the 2. line "REGISTERTITLES/M/A"
"button intro" options "NUM=BUTTONS/K/N/A,ROWS/K/N,COLS/K/N,HELP"
"button" options "TITLE/A,IMG=IMAGE/K,KEY=SHORTCUT/A,CMD=COMMAND/A,PATH/A,STACK/N/A,PRI=PRIORITY/N/A,Q=QUIET/S,WBSTART/S,REMAP/S,TRANS/S,HELP"
options of the program: "CFG=CONFIG/K,Q=QUIET/S"
options of the 1. line "T=TOP/N/K,L=LEFT/N/K,W=WIDTH/N/K,MD=MEMORYDISPLAY/S,TD=TITLEDISPLAY/S,CP=COMMANDPANEL/S,MDW=MDWeight/N,TDW=TDWeight/N,CPW=CPWeight/N,CHIP/S,FAST/S,VMEM/S,HISTORY/K"
-- default values from classes/CommandLauncher.c
data->command = data->args = data->path = 0;
data->stack = 4096;
data->prio = 0;
data->quiet = 0;
-- default values from classes/CommandPanel.c
commandline = NewObject(CL_CommandLauncher->mcc_Class,NULL,
MUIA_CommandLauncher_Stack , 8192,
MUIA_CommandLauncher_Priority , 0,
MUIA_CommandLauncher_Path , "RAM:",
TAG_DONE));
-- Because remapping was too slow I've hacked this quick and dirty "Icon-Grabber"
into it. It works fine with NewIcons installed.
if (data->dobj = GetDiskObjectNew(data->name))
{
if (data->bmp = AllocBitMap(data->dobj->do_Gadget.Width,data->dobj->do_Gadget.Height,8,BMF_CLEAR,0))
{
struct RastPort TMPRP;
InitRastPort(&TMPRP);
TMPRP.BitMap = data->bmp;
DrawImage(&TMPRP,data->dobj->do_Gadget.GadgetRender,1,1);
...
-- versions:
atb.000 for plain 68000 lovers (no optimizations)
atb.020 heavy 020 and above optimized (no math -> no fpu)
atb.020+VMM atb with VMM polling (affects memory display)